home
download
documentation
mailing lists
wiki
IRC
forums
daily builds
feature requests
bug reports
patches

Setting up a cygwin Rockbox development environment

Eric Lassauge has kindly compiled the SH-1 and 68K/COLDFIRE cross GCC tools as Cygwin packages and put them up for us to use. (SH-1 = archos, 68K/coldfire = iriver)

WARNING These versions do not work correctly to build current rockbox code. You are strongly advised to build your own CrossCompiler instead.. It will fail when it reaches dumb, as preglow so eloquently put it in irc "dumb will vomit". "cygwin doesn't like us these days"...

• Step 1: Download the cygwin installer
• Step 2: Install the base development environment
• Step 3: Select Eric's mirror site and install
• Step 4: Set the PATH variable

Step 1: Download the cygwin installer

Go to the cygwin home page, http://www.cygwin.com and download setup.exe from there ("Install or update now!").

Step 2: Install the base development environment

If you are unsure about the questions asked by the installer, just choose the default.

When you are asked to select the packages to install, select the following, except for the Base, which is required:

• Archive - zip
• Archive - unzip
• Devel - binutils
• Devel - cvs
• Devel - gcc
• Devel - gcc-mingw-core
• Devel - gdb (if you want to debug simulator code)
• Devel - make
• Devel - mingw-runtime
• Devel - patchutils
• Interpreters - perl

Step 3: Select Eric's mirror site and install

Start the Setup program again. When the installer prompts you for a mirror site URL, enter http://lassauge.free.fr/cygwin/ in the "User URL" field.

Select these packages (for SH1) and install:

• Devel - sh-elf-binutils (latest version is 2.15)
• Devel - sh-elf-gcc (latest version is 3.3.5)
• Devel - uclpack (optional)
• ( Forget the previously released packages that were named sh-binutils and sh-gcc)

Or these packages (for 68K/COLDFIRE) and install:

• Devel - m68k-elf-binutils (latest version is 2.15.96)
• Devel - m68k-elf-gcc (latest version is 3.4.3-EL-2 -earlier versions will fail to compile some of the codecs)
• ( Normally the binutils version is now OK)

You can also select the pseudo package Devel - rockbox-devel and all the above packages will be selected.

If you want to have sound in the uisimulator you can get and install the following package:

• Sound - libmad (latest version is 0.15b)

Step 4: Set the PATH variable

Now you edit your .bash_profile and add the following last:

   PATH=${PATH}:/opt/sh1/bin

or

   PATH=${PATH}:/opt/m68k/bin

Done. Happy hacking!